home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / standard / disassembler.z / disassembler
Text File  |  1998-10-30  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. DDDDIIIISSSSAAAASSSSSSSSEEEEMMMMBBBBLLLLEEEERRRR((((3333XXXX))))                                              DDDDIIIISSSSAAAASSSSSSSSEEEEMMMMBBBBLLLLEEEERRRR((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      disassembler - disassemble a MIPS instruction and print the results
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiinnnntttt ddddiiiissssaaaasssssssseeeemmmmbbbblllleeeerrrr ((((iiiiaaaaddddrrrr,,,, rrrreeeeggggssssttttyyyylllleeee,,,, ggggeeeetttt____ssssyyyymmmmnnnnaaaammmmeeee,,,, ggggeeeetttt____rrrreeeeggggvvvvaaaalllluuuueeee,,,,
  13.                ggggeeeetttt____bbbbyyyytttteeeessss,,,, pppprrrriiiinnnntttt____hhhheeeeaaaaddddeeeerrrr))))
  14.      uuuunnnnssssiiiiggggnnnneeeedddd  iiiiaaaaddddrrrr;;;;
  15.      iiiinnnntttt       rrrreeeeggggssssttttyyyylllleeee;;;;
  16.      cccchhhhaaaarrrr      ****((((****ggggeeeetttt____ssssyyyymmmmnnnnaaaammmmeeee))))(((())));;;;
  17.      iiiinnnntttt       ((((****ggggeeeetttt____rrrreeeeggggvvvvaaaalllluuuueeee))))(((())));;;;
  18.      lllloooonnnngggg      ((((****ggggeeeetttt____bbbbyyyytttteeeessss))))(((())));;;;
  19.      vvvvooooiiiidddd      ((((****pppprrrriiiinnnntttt____hhhheeeeaaaaddddeeeerrrr))))(((())));;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _D_i_s_a_s_s_e_m_b_l_e_r disassembles and prints a MIPS machine instruction on
  23.      _s_t_d_o_u_t.
  24.  
  25.      _I_a_d_r is the instruction address to be disassembled.  _R_e_g_s_t_y_l_e specifies
  26.      how registers are named in the disassembly; if the value is 0, compiler
  27.      names are used; otherwise, hardware names are used.
  28.  
  29.      The next four arguments are function pointers, most of which give the
  30.      caller some flexibility in the appearance of the disassembly.  The only
  31.      function that MMMMUUUUSSSSTTTT be provided is _g_e_t__b_y_t_e_s. All other functions are
  32.      optional.  _G_e_t__b_y_t_e_s is called with no arguments and returns the next
  33.      byte(s) to disassemble.
  34.  
  35.      _G_e_t__s_y_m_n_a_m_e is passed an address, which is the target of a _j_a_l
  36.      instruction. If NNNNUUUULLLLLLLL is returned or if _g_e_t__s_y_m_n_a_m_e is NNNNUUUULLLLLLLL, the
  37.      _d_i_s_a_s_s_e_m_b_l_e_r prints the address; otherwise, the string name is printed as
  38.      returned from _g_e_t__s_y_m_n_a_m_e. If _g_e_t__r_e_g_v_a_l_u_e is not NNNNUUUULLLLLLLL, it is passed a
  39.      register number and returns the current contents of the specified
  40.      register.  _D_i_s_a_s_s_e_m_b_l_e_r prints this information along with the
  41.      instruction disassembly.  If _p_r_i_n_t__h_e_a_d_e_r is not NNNNUUUULLLLLLLL, it is passed the
  42.      instruction address _i_a_d_r and the current instruction to be disassembled,
  43.      which is the return value from _g_e_t__b_y_t_e_s. _P_r_i_n_t__h_e_a_d_e_r can use these
  44.      parameters to print any desired information before the actual instruction
  45.      disassembly is printed.
  46.  
  47.      If _g_e_t__b_y_t_e_s is NNNNUUUULLLLLLLL,,,, the _d_i_s_a_s_s_e_m_b_l_e_r returns -1 and errno is set to
  48.      EEEEIIIINNNNVVVVAAAALLLL;;;; otherwise, the number of bytes that were disassembled is
  49.      returned.  If the disassembled word is a jump or branch instruction, the
  50.      instruction in the delay slot is also disassembled.
  51.  
  52.      The program must be loaded with the object file access routine library
  53.      lllliiiibbbbeeeellllffffuuuuttttiiiillll....aaaa.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      ldfcn(4).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.